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|- o R0DUCTI0N AND OVERVIEW 
1.1 BACKGROUND 

The 802 logical link control layer server (802 lie Is) Is a 
component of the lacs driver in the Ian subsystem. The 802 lie 
Is interfaces to the lie type 1 layer instance in the lacs. The 
802 lie Is can be termed a 16 entension of the lacs layer 
instance. The 802 lie Is currently supports type 1 services 
only. 

1 .2 BASIC PURPOSE 


The 802 lie Is is an extension of the 802 lie layer entity 
In the lacs. The user of this service will be operating in a 
connectionless enviroment. The type 1 lie user must associate, 
then activate the local and remote saps as described In the Idis 
component specification. The user may then issue read, write, 
event or deactivate with queue abort requests. The read and 
write requests must include the remote sap the user wishes to 
commuicate with.. 

The 802 lie Is has several purposes, they are: processing 
read data, transmit data, and event requests and processing flow 
control at the sap level. 

1 .3 BASIC STRUCTURE 

| Figure 1 shows the relation of the 802 lie Is to the other 
components of the lacs dlrver. Figure 2 shows the subcomponents 
of the 802 lie Is. The following Is a brief description of the 

functions of each subcomponent of the 802 lie Is. 

determination routine - This routine determines which 
routine to branch to, the desision is made from the major 

function code In the lorb. The routine wll I branch to the 
xm i t data or read data or event request processing routines 
depending on the lorb function code. 

transmit data request processing routine - This routine will 
perform pre and post processing of the transmit data lorb. 

The routine will build a xm 11 data I cb from Information In 

the lorb, issue the leb to the lacs. When the lacs 

completes the leb, the routine will update the lorb status, 
then post the request back to the user. 


read data request processing routine - This routine will 
perform pre and post processing of the read data lorb. The 
routine will build a read data leb from Information in the 
lorb, Issue the leb to the lacs. When the lacs completes 
the leb, the routine will update the iorb status, then post 
the request back to the user. 
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LAN L6 SOFTWARE ARCHITECTURE 
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event request processing routine - This routine will perform 
pre and post processing of event lorbs. The routine will 
build an event Icb from Information in the lorb and the 
event mask In the rt, then issue the Icb. When the lacs 
completes the Icb, the routine will update the lorb status, 
then post the request back to the user. 

flow control routines - These routines will test flow 
control counts for the sap. The lacs maintains the counts 
and these routines update the counts via a credit mechanism 
which is defined in the eps. 

issued to the lacs. After the determination the routine 
will return to the calling routine wilh a status specifying 
whether the Icb can be sent or not. 

1 .4 BASIC OPERATION 

1.4.1 DETERMINATION ROUTINE 

The determination routine is invoked via a branch from the Idls 
determination routine. All requests issued to the 802 lie Is 
enter at this routine. The routine will fetch the major function 
code from the lorb, from the function code the routine will branch 
to either the xmit data routine, read data routine or event 
routine. 

1.4.2 TRANSMIT DATA REQUEST PROCESSING ROUTINE 

The xm i t data request processing routine will be invoked via a 
branch from the determination routine for pre request processing 
or a call from the I dms when a Icb is completed for post request 
processing. Therefore the routine has two subcomponents: pre 

request processing and post request processing. The routines are 
defined below: 

xmit data pre request processing routine - This routine will 
validate the request. Call the build Icb routine in the 
Idls. The routine will fill in the lie type 1 specific 
fields of the Icb. The routine will call the executive 
address absoultizing routine and place the address(es) into 
the Icb. The routine will call the flow control routine. 
Upon return from the flow control routine if there is no 
error the routine will call the Idms to issue the Icb to the 
lacs. When the I dms return the routine will call the 
terminate task rotuine in the Idis. 

Errors reported by the xmit data pre request processing 
routine are: 

, 1. Invalid iorb parameter. 

2. Flow control routine returns an error. 

3. Ldms rotuine returns an error. 
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4. Build Icb routine returns an error. 

( xmit data post request processing routine - This routine 

will be invoked at interrupt level from a call from the 
Idms. The routine will be passed a pointer to a completed 

Icb, from the Icb the routine will find the iorb associated 
with the Icb, update the iorb status from Information In the 
completed Icb. The routine will call the flow control 
routine. The routine will then return to the Idms so the 
Idms can finish it's interrupt processing. 

Errors are reported by the xmit data post request processing 
routine are: 

1. Flow control routine returns with an error. 

1.4.3 READ DATA REQUEST PROCESSING 

The read data request processing routine will be invoked via a 
branch from the determination routine for pre request processing 
or a call from the Idms when a Icb is completed for post request 
processing. Therefore the routine has two subcomponents: pre 

request processing and post request processing. The routines are 
defined below: 




read data pre request processing routine - This routine will 
validate the request. Call the build Icb routine in the 
Idis. The routine will fill In the lie type 1 specific 
fields of the Icb. The routine will call the . execut i ve 
address absoultizing routine and place the address(es) Into 
the Icb. The routine will call the flow control routine. 
Upon return from the flow control routine if there is no 

error the routine will call the Idms to issue the Icb to the 

lacs. When the Idms return the routine will call the 
terminate task rotuine In the Idis. 

Errors which may occur In the read data pre request 
processing routine are: 

1. Invalid iorb parameter. 

2. Flow control routine returns an error. 

3. Ldms rotuine returns an error. 

4. Build Icb routine returns an error. 

read data post request processing routine - This routine 

will be Invoked at Interrupt level from a call from the 
Idms. The routine will be passed a pointer to a completed 
Icb, from the Icb the routine will find the iorb associated 
with the Icb, update the Iorb status from information In the 
completed Icb. The routine will call the flow control 

routine. The routine will then return to the Idms so the 
Idms can finish it's interrupt processing. 
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Errors are reported by the read data post request processing 
routine are: 

1.4.4 EVENT REQUEST PROCESSING 

The event request processing routine will be Invoked via a branch 
from the determination routine for pre request processing or a 
call from the I dms when a Icb Is completed for post request 
processing. A chagne event mask request can also be Issued. 

Therefore the routine has three subcomponents: pre request 

processing and post request processing and change event mask. The 
routines are defined below: 

event request pre processing routine - This routine will 
upon receiving the request determine from the device 
specific bits In the iorb if the request is a change event 
mask request and if so will jump to the change event mask 
routine. Otherwise, the routine will set the event request 
processing bit in the first tt. If there is an event 

request outstanding the routine will dequeue and post the 

current event with an error status, then enqueue the reuqest 
on the first tt. The routine will then test if there any 
event Icbs queued on the event Icb queue. If there are Icbs 
queued the routine will check the mask of each completed 
event Icb for a matching mask in the Iorb. If a matching 

mask is found, the event request is updated, the event which 
occured is placed In the iorb and the request is dequeued 

and posted, the routine will then turn off the event request 

processing bit off and terminate the task. If a matching 

mask is not found in the queue of event Icbs, the routine 

will turn off the event request processing bit off and 
terminate the task. If no Icb are on the event queue, the 
routine will turn of the event request processing bit and 

terminate the task. 

Errors which may occur in the event request pre processing 
routine are: 

1. Invalid iorb parameter. 

event request post processing routine - This routine will be 
Invoked when a event Icb is completed by the lacs. The 

routine will test the event request processing bit, if the 
bit is set the routine will queue the Icb on the tail of the 
event Icb queue off the first tt, then return to the Idms. 
If the bit is not set, the routine will test if there Is an 
event iorb outstanding. If there Is no event iorb 
outstanding the routine will queue the Icb on the tail of 
the event Icb queue off the tt, then return to the Idms. If 
an event iorb Is outstanding, the routine will test if the 
event iorb matches the mask in the event Icb, if the masks 
do not match the Icb Is queued on the tail of the event Icb 
queue off the tt, and returns to the Idms. If a match is 
found the routine will dequeue the event Iorb, update the 
iorb status. 
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place the event mask from the Icb into the Iorb, then posts 
the request, the routine will then return to the Idms. 

Errors which may occur In the event request post processing 
routlne are: 


Currently there no errors. 

change event mask routine - This routine will be Invoked by 
the event request pre processing routine. When this routine 
Is activated there will be a pointer to an change event mask 
Iorb. The routine will change the event mask field In the 
tt, then dequeue and post the reuqest, then terminate the 
task. 

Errors which may occur during processing of the change event 
mask rotulne are: 


1. Invalid Iorb parmameter. 
1.4.5 FLOW CONTROL PROCESSING 


3 



There are two flow control routine In the 802 type 1 lie Is, 
they are pre order flow control processing and post order flow 
control processing. 

pre order flow control routine - This routine will be called 
by the read data or transmit data pre request processing 
routines. The routine will test If the user has exceeded 
the read or write credit value, and If so the routine will 
post the request back to the user with an error, then return 
to the caller with an error status. Otherwise, the routine 
will return to the calling routine with a successful status. 


post order flow control routine - This routine will be 
called by the read data or transmit data post request 
Interrupt processing outlnes. The routine will add the 
credit amount to the current credit amount, then return to 
the calling routine. 


2 EXTERNAL SPECIFICATIONS 

2.1 OWNED DATA STRUCTURES 

The the data structures owned and used by the Ian subsystem are 
defined In the Ian 16 data structures document. 

2.2 EXTERNAL INTERFACES 

2.2.1 M0D400 EXECUTIVE SOFTWARE ROUTINES 

2.2.1.1 ZHCOMM - Nul l address 

(y function: Will load the null address when referenced l.e. Idb 
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$b5,<zhcomm will load $b5 with the null address. 

2.2.1.2 ZXD_TR - Internal terminate 

entry: Inj $b5,zxd_tr 

Input: $r2 = completion status for request 

$b4 * new default start address or null 
$b5 = return 

output: $r1 = 0 - no error on Internal terminate 

Sb 1 * address of IRB for next request or is null if 

hardware Interrupt 

$b4 = address of RB for next request 
modifies: any register may be modified 

function: Dequeue and post currently dispatched request. Get 

next request in queue of task requests. Delete task If 
queue empty and delete bit on. Suspend task until next 
request or hardware Interrupt at issuing task's level 
If queue empty and delete bit off. 

2.2.2 STANDARD I0RB FORMAT 

r b_Irx 

input - bit 0 - rb_adr points to a bd when set 
bit 1-3 - na 

bit 4-f - Irn when rb_ct2 bits 0-7 = x'fd' 
output - na 

rb_rrb 

input: na 

output: na 

rb_ct1 

input: bit 0-7 - mbz 

bit 8-e - na 
bit f - must be set 
output: bit 0-7 - status 

60 - event successful 

64 - Invalid iorb parmaeter 

6b - event aborted, reference rb_ fss field 
for reason 

6c - inconsistent request, reference rb_ fss 

field for reason 
- same as input 
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( 


r b ct2 


Input: 


output: 


rb adr 


Input: 


output: 


r b_rng 


Input: 



output: 

rb_dvs 

input: 
output: 

r b_rsr 

Input: 
output: 


rb stl 


Input: 
output: 


bit 0-7 - Irn 

bit 8-a - na 

bit b - must be set 
bit c-f - function code 
bit c-f = e - event iorb 

bit c-f = 1 - write iorb 

bit c-f = 2 - read Iorb 
same as Input 


pointer to buffer, or if rb_lrx bit 0 is set this 
field contains a pointer to a buffer discrlptor, 
or this field may be null If no data Is being 
passed (i.e. event iorb) 
same as input 


range of the buffer, or total range of all buffers 
in the buffer discrlptor block if bit 0 in rb_lrx 
is set, or mbz if no data is being passed 
same as input 


bit 0-7 - class of service 
bit 8-f - mbz 
same as input 


mbz 

residual range of the buffer for read operations 
only, or same as input for all other operations 


mbz 

bit 0-7 - same as input 

bit 8 - Invalid function code when set 

bit 9 - ram memory exausted when set 

bit a - ram location non-existent when set 

bit b - ram parity error when set 

bit c - level 6 memory yellow when set 

bit d - level 6 memory non-existent when set 

bit e - level 6 bus parity error when set 

bit f - level 6 memeory red when set 
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rb_ext 

input: bit 0-7 - xx 

bit 8-f - xx 

output: same as Input 

rb_fsf 

input: function specific function code 

iorb function code = e 

0010 - sap event 
0020 - connection event 
0040 - sm event 
Iorb function code * 1 
0010 - cI write 
0020 - co write 
0040 - expideted co write 
iorb function code = 2 
0010 - cl read 
0020 - co read 
0040 - expideted co read 

output: same as input 

rb_fss 

input: mbz 

output: function specific status 

0001 - sap already active 

0002 - lack of resources 

0004 - controller down 

0008 - sm Is error 

0010 - Irn already in use 

0020 - sap already active 

0040 - sap already disconnected 

0080 - receive buffer too small 

rb_abs 

input: mbz 

output: accual buffer size when rb_fss * 0080, otherwise 

same as Input 

r b_I ra 

Input: logical remote address for writes, mbz for read 

and event requests 

output: logical remote address for read, otherwise same as 

input 
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2.2.2.1 EVENT I0RB EXTENSIONS 



rb evm 


Input: event mask 

bit f - data arrival event 
bit e - additional write credits available 
bit d - sap deactivated 
output: same as input 

rb ev I 


input: mbz 

output: event indication mask 

bit f - data arrival event 

bit e - additional write credits available 

bit d - sap deactivated 

r b e I f 


input: 

output: 


mbz 

amount of additional write credit when rb_evi bit 
e set, otherwise same as input 


rb ecb 


( 


2 . 2 . 2.2 


input: mbz 

output: trash 

WRITE I ORB EXTENSION 


rb awe 


input: mbz 

output: amount of additional write credit 

rb web 


input: mbz 

output: trash 


2.2.2.3 READ I0RB EXTENSION 


rb arc 


Input: mbz 

output: amount of additional read credit 
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rb 

2.2.3 

cb 

cb 

cb 

cb 

cb 


cb 

cb 


rcb 


Input: mbz 

output: trash 

STANDARD LCB FORMAT 

pr I 

Input: mbz 

output: na 


neb 


Input: mbz 

output: na 

ret 

input: address of caller’s ret 

output: same as input 

I It 

input: address of the lit In which this leb wil 

queued 

output: same as input 

f rw 


input: bit 0-3 - 9 

bit 4-7 - mbz (iorb major function code ?) 
bit 8-f - xx 

output: same as input 

Itp 

input: address of the post processing routine, or 

on null 

output: same as Input 

i nd 


input: Indicators 

bit 7 - cb_itp points to a trb when set 
bit 6 - sm leb when set 
a I I other bits mbz 
output: same as Input 
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cb_Icw 

^ input: bit 0-5 - mbz 

bit 6-9 - cpu number to Interrupt 
bit a-f - level to Interrupt the cpu 
output: same as Input 

cb_fsf 

Input: function specific function code 

function codes for read Icbs are: 

0012 - cl read 
0022 - co read 
0042 - co expideted read 
function codes for write Icbs are: 

0011 - cl write 
0021 - co write 
0042 - co expideted write 
function codes for event icbs are: 

OOle - sap event 
002e - connection event 
004e - sm event 
output: same as input 

cb_cts 

Input: mbz 

C output: bit 0-7 - rfu and mbz 

bit 8 - Invalid function code when set 

bit 9 - ram memory exausted when set 

bit a - ram location non-existent when set 

bit b - ram parity error when set 

btt c - level 6 memory yellow when set 

bit d - level 6 memory non-existent when set 

bit e - level 6 bus parity error when set 

bit f - level 6 memeory red when set 

cb_f ss 

input: mbz 

output: function specific status 

0001 - sap not active 
0002 - lack of resources 
0004 - controller unavailable 
0008 - sm layer instance error 
0020 - sap already active 
0040 - sap already deactivated 
0080 - recieve buffer too small 
0100 - Illegal logical address 
0200 - Invalid Icb 
0400 - write credit violations 
0800 - read credit violations 

( 
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cb cbs 


input: 
output: 


cb abs 


input: 
output: 


cb I sa 


input: 
output: 


cb Ira 


input: 
output: 


cb_trg 


input: 
outp ut: 


cb bet 


input: 
output: 


cb ad 1 


input: 
output: 


cb_rg1 


input: 
outp ut: 


cb rsl 


input: 
output: 


mbz 

bit 0 - leb is complete when set 
bit 1 - leb not processed when set 
bit 2-f - rfu and mbz 


mbz 

actual buffer size if cb_ fss * 0080, otherwise 

same as input 


logical local address for cl operations 
same as input 


logical remote address for cl write operation, mbz 
for event and read operations 

logical remote address for cl read operations, 
otherwise same as Input 


total byte range 
same as input 


number of buffers 
same as Input 


buffer #1 address 
same as Input 


buffer #1 range 
same as input 


mbz 

buffer #1 residual range 


« 


X"" X, 
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cb ad2 


Input: 

output: 


cb_rg2 


input: 

output: 


cb rs2 


Input: 
output: 


cb ad3 


input: 

output: 


cb_rg3 


input: 
output: 


cb rs3 


Input: 

output: 


cb ad4 


Input: 

output: 


cb_rg4 


Input: 
output: 


cb rs4 


Input: 
output: 


cb ad5 


Input: 

output: 


cb_rg5 



Input: 
output: 


buffer #2 address 
same as input 


buffer #2 range 
same as Input 


mbz 

buffer #2 residual range 


buffer #3 address 
same as input 


buffer #3 range 
same as Input 


mbz 

buffer #3 residual range 


buffer #4 address 
same as input 


buffer #4 range 
same as input 


mbz 

buffer #4 residual range 


buffer #5 address 
same as Input 


buffer #5 range 
same as input 
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cb rs5 


Input: 

output: 


cb ad6 


Input: 
output: 


cb_rg6 


Input: 
output: 


cb rs6 


Input: 

output: 


cb ad7 


Input: 
output: 


cb_rg7 


Input: 
outp ut: 


cb rs7 


Input: 
output: 


cb ad8 


lnput: 
output: 


cb_rg8 


Input: 
output: 


cb rs8 


input: 
output: 


mbz 

buffer #5 residual range 


buffer #6 address 
same as Input 


buffer #6 range 
same as Input 


mbz 

buffer #6 residual range 


buffer #7 address 
same as Input 


buffer #7 range 
same as Input 


mbz 

buffer #7 residual range 


buffer #8 address 
same as Input 


buffer #8 range 
same as input 


mbz 

buffer #8 residual range 
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2..2.3.1 

< 


cb 


EVENT LCB EXTENSIONS 
ev I 


input: mbz 

output: event Indication mask 

bit f - data arrival event 

bit e - additional write credits availbale 

bit d - sap deactivated 

cb ei f 


Input: mbz 

output: event Information field 

aditional write credit (only if cb_evi = 0002) 
lenght of read buffer (only if cb_evI = 0001) 
reason for sap deactivatin (only If cb_evi * 0004) 


2.2.3.2 READ LCB EXTENSION 


cb arc 


input: mbz 

output: read credit count 


2.2.3.3 WRITE LCB EXTENSION 


I cb_awc 

input: mbz 

output: additional write credit 

2.2.4 MOD400 EXTERNAL DATA STRUCTURES IMPLEMENTED 


The following system owned data structures are referenced by the 
I Ic 802 I Ic Is: 


Task Control Block (TRB) 

System Control Block (SCB) 
Logical Resource Table (LRT) 
Group Control Block (GCB) 
Resource Control Table (RCT) 
Intermediate Request Block (IRB) 


2.2.5 LACS DRIVER INTERFACE SERVICES ROUTINE USED 


The 802 lie Is uses the following Idls routines, the 
definition of the Input and output parameters can be found In the 
Idls component specification: 



I sb I cb 
i svIob 
i stmtk 
i sevnt 
I sasvb 
l sabs I 


build Icb 

vaIidate I orb 

terminate task 

evnet routines 

assign segiment visiblity 

absoultize buffers 
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2.2.6 LACS DRIVER MEGABUS SERVICES ROUTINES USED 

The 802 lie Is uses the following I dms routines, the 

definition of the Input and output parameters can be found in the 

I dms compnent specification. 

msiior - Issue fold or issue io routine 

2.3 INITIALIZATION REQUIREMENTS 

The elm process will load the lie 802 lie Is into system 

memory, and configure at least one task level for the lie 802 lie 

Is to run under. When the lie 802 lie Is is loaded Into memory, 
it will perform a Initialization subroutine. This routine will: 

1. Reclaim patch space. 

No initialization processing Is done when the lie 802 lie Is 
is activated initially by a request. 

2.4 TERMINATION REQUIREMENTS 

The Me 802 lie Is will be active as long as mod400 is 
active, therefore there are no termination requirements. 

2.5 ENVIRONMENT 

The following Items are required by the lie 802 lie Is for 
it to perform it's task: 

1. Mod400 operating system. 

2. Any 16 computer model except 6/10 and 6/20. 

3. A lacs attached to the 16 megabus. 

4. Lan elm. 

5. System manager layer server. 

6. A user of the lan subsystem to driver the lie 802 lie 
I s. 

2.6 TIMING AND SIZE REQUIREMENTS 

Currently memory usage and timing requirements are not an 
Issue. However, the code should be be as efficient as possible. 

2.7 ASSEMBLY AND LINKING 

The software will be written in Series 6 Assembly Language 
using a subset of the instruction set that is present on all 
Series 6 systems. The lie 802 lie Is will be linked by the gcos6 
mod400 linker to produce one of the lacs driver's bound units. 
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2.8 TESTING CONSIDERATIONS 

( 

’ Since the product Is new, all functions will be tested by 

the developer, and software test. 

2.9 DOCUMENTATION CONSIDERATIONS 

The lie 802 lie Is source listing will include a program 
design language used by the developer to aid In the maintenance by 
future developers and also to aid In the development by the 
developer. 

2.10 ERROR MESSAGES 

2.10.1 I ORB ERROR MESSAGES 

1. 0164 - Invalid Iorb parameters. 

2. 016b - Request was not processed. 

3. 016c - Inconsistent request. 

3 INTERNAL SPECIFICATION 

3.1 OVERVIEW 

The 802 lie Is Is activated by either the Idis determination 

( routine branching to the type 1 determination routine or a call 
from the I dms to one of the 802 lie Is Interrupt routines, the 
interrupt routine must return to the Idms. 

3.2 SUBCOMPONENT DESCRIPTION 

3.2.1 DETERMINATION ROUTINE 

The determination routine Is Invoked by the Idts determination 
routine. The Idls determination routine performs a branch to the 
802 lie Is determination routine. The Idls determination routine 
will supply the following input parameters: 

$ b1 = a(Irb) 

$b2 = a(rct) 

$b4 = a(lorb) 

The 802 lie Is determination routine supplies the following output 
parameters: 

$b1 * a(irb) 

$b4 = a(iorb) 

$b2 = a(rct) 

The routine performs the following function: 

( 
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1. Retrieve the major function code from the lorb. 

2. Using a jump table index into the table by the major 
function code to jump to the appropriate routine. The 
jump table Is described below: 

jmptbI equ $ 

jmp error function code = 0 

jmp xmitdata function code = 1 

jmp readdata function 

code = 2 

jmp error function 

code = 3 


jmp event function 

, code = e 

jmp error function 

code = f 

Where xmitdata is the xmit data routine, readdata is the 
read data routine, and event is the event routine, and 

error Is a Invalid function code handling routine. 

3.2.2 XMIT DATA ROUTINES 

3.2.2.1 XMIT DATA PRE PROCESSING ROUTINE 

The xmit data pre processing rotuine is invoked by the 802 lie Is 
determination routine. The xmit data preprocessing routine 
requires the following Input parameters: 

$ b1 = a(!rb) 

$b2 = a(rct) 

$b4 = a(iorb) 

The xmit data pre processing rotuine supplies the following 

output parameters: 

none - task is terminated 

The routine performs the following function: 

1. Validate the lorb, this Involves testing the extension 
field to see if the iorb is of proper lenght, the range 
field must be non zero, and test of other fields that 
will be determined when the routine is inplemented. If 
an lorb is Invalid, the routine will call the dequeue 
and post routine with an invalid lorb error status. 

2. If the iorb is valid the routine will set a pointer to 
the leb (in the extended iorb), then call the build leb 
rout Ine in the Idis. 
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3. Upon return from the build Icb routine, the rotlne will 
fill in the following fields of the Icb: 


cb_frw - set the left byte to 9, set the right 

byte to the range of the Icb from the 

ct>_sz word. 

cb_!tp - set the address of the xmit data post 

processing routine. 

cb_ind - currently no bits are set, field Is 

cI eared. 


cb_csf - set the channel specific function code, 
where the code Is retrieved from Is 
tbd. 


4. The routine will call the flow control routine. If an 
error occurs the routine will call the terminate task 
rout Ine. 

5. If no error resulted from the call to the flow control 
routine, the xmit data pre processing routine will set 
up the registers for the cal I to the Idms, then cal I the 
Idms. 

4 

6. If the Idms returns to the xmit data pre processing 
routine with an error the routine will tbd, then call 
the terminate task routine. 

7. If the Idms returns with no error, the xmit data routine 
will call the terminate task routine. 


3.2.2.2 XMIT DATA POST PROCESSING ROUTINE 


The xmit data post processing routine Is Invoked by the Idms when 
an Icb completes. The Idms retrieves the cb_itp field from the 
Icb and performs a Inj to the address. The address In the Icb 
will be this routine. The xmit data pre processing routine sets 
up the address. The xmit data post processing routine requires 
the following Input parameters: 

$b1 = a(Icb) 

$b5 = return address 



The routine will supply the following output parameters: 

none - returns to the address In the inputed $b5 
The routine performs the following function: 

1. Retrieve the pointer to the iorb associated with the 
Icb. 

2. Update the rb_st1 in the lorb status word from the cb 
csf and cb cts fields in the Icb. 
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3. Call the flow control routine. 

4. Call the dequeue and post routine in the Idis. 

5. Return to the Idms. 

3.2.3 READ DATA ROUTINES 

3.2.3.1 READ DATA PRE PROCESSING ROUTINE 


The read data pre processing rotuine is invoked by the 802 lie Is 
determination routine when a read iorb Is Issued by the user. 
The read data preprocessing routine requires the following input 
parameters: 


$ b1 = a(Irb) 

$b2 = a(rct) 

$b4 = a(iorb) 

The read data pre processing rotuine supplies the following 
output parameters: 

none - task is terminated 

The routine performs the following function: 

1. Validate the Iorb, this Involves testing the extension 

field to see If the iorb is of proper lenght, the range 

field must be non zero, and test of other fields that 
will be determined when the routine Is Inplemented. If 
an iorb is invalid, the routine will call the dequeue 

and post routine with an invalid iorb error status. 

2. If the Iorb is valid the routine will set a pointer to 

the leb (in the extended iorb), then call the build leb 
rout Ine In the Idis. 

3. Upon return from the build leb routine, the rotine will 
fill In the following fields of the leb: 


cb_frw - set the left byte to 9, set the right 
byte to the range of the leb from the 
cb_sz word. 

cb_ltp - set the address of the read data post 
processing routine. 

cb_Ind - currently no bits are set, field Is 
cI eared. 


cb_csf - set the channel specific function code, 
where the code Is retrieved from is 
tbd. 
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4. The routine will call the flow control routine, if an 
error occurs the routine will call the terminate task 
routine. 

5. If no error resulted from the call to the flow control 
routine, the read data pre processing routine will set 
up the registers for the cal I to the Idms, then cal I the 
I dms. 

6. If the Idms returns to the read data pre processing 
routine with an error the routine will tbd, then call 
the terminate task routine. 


7. If the Idms returns with no error, the read data routine 
will call the terminate task routine. 

3.2.3.2 READ DATA POST PROCESSING ROUTINE 


The read data post processing routine Is Invoked by the Idms when 
an Icb completes. The Idms retrieves the cb_Itp field from the 
Icb and performs a Inj to the address. The address in the Icb 
will be this routine. The read data pre processing routine sets 
up the address. The read data post processing routine requires 
the following Input parameters: 



$b1 = a(Icb) 

$b5 = return address 

The routine will supply the following output parameters: 


none - returns to the address In the inputed $b5 


The routine performs the following function: 

1. Retrieve the pointer to the iorb associated with the 
Icb. 

2. Update the rb_st1 In the Iorb status word from the cb 
csf and cb_cts fields in the Icb. 

3. Call the flow control routine. 

4. Call the dequeue and post routine In the Idis. 

5. Return to the Idms. 


3.2.4 EVENT ROUTINES 


3.2.4.1 EVENT REQUEST PRE PROCESSING ROUTINE 

The event request pre processing routine Is Invoked by the type 1 
determination routine via a branch. The routine will require the 
following Input parameters: 
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$b1 * a(Irb) 

$b2 = a(rct) 

$b4 = a(iorb) 

The read data pre processing rotuine supplies the following 
output parameters: 

none - task Is terminated 

The routine performs the following function: 

1. If bit 0 in the rb_dvs word Is not set, then call the 
post request routine with an invalid iorb parameter 
status, call the terminate task routine. 

2. if bit 0 is set in the rb_dvs word, set the event active 
bit in the tt_id1 word in the tt. 

3. If there is an event iorb pointer in the tt_erb field, 
then call the post request routine to post the request 
pointed to by the tt_erb field with an error status. 

4. Place the pointer to the iorb into the tt_erb field. 

5. If any event Icbs are are in the event Icb queue then 
test search the queue looking for a matching event mask, 
mask in iorb and Icb must match. If a match is found 
call the post request routine with a successful status, 
clear the tt_erb field, set the event active bit off and 
call the terminate task routine. 

6. If no event Icb are in the queue or a matching mask is 
not found to the iorb in the event Icb queue set the 
event active bit off, call the terminate task routine. 

3.2.4.2 EVENT REQUEST POST PROCESSING ROUTINE 

The event request post processing routine Is Invoked by Inj from 
the I dms when it has a completed event Icb. The routine requires 
the following input parameters: 

$ b1 = a(Icb) 

$b5 * return address 

The routine supplies the following output parameters: 

none - a return to the Idms Is performed 
the routine performs the following function: 

1. Retrieve the pointer to the tt. 

2. If the event active bit is set, queue the Icb on the 
tail of the event Icb queue, return to the Idms. 
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3. If the event active bit Is not set, test If there Is an 

event lorb. If there Is no event lorb queue the Icb on 

the tall of the event Icb queue, return to the Idms. 

4. If there Is an event lorb, queue the Icb on the tall of 

the event Icb queue, search from the start of the event 

Icb queue. If a matching mask Is found, call the post 
routine with a successful status, return to the Idms. 

5. If there Is no matching mask found return to the Idms. 

2.5 FLOW CONTROL ROUTINES 

2.5.1 PRE ORDER FLOW CONTROL ROUTINE 

The pre order flow control routine is invoked via a Inj 

from the recleve or transmit data pre request processing 
routines. The routine requires the following Input parameters: 

$b4 = a(I orb) 

$b2 = a(rct) 

$b5 = a(return) 

The routine supplies the following output parameters: 

$b4 = a(lorb) 

$b2 = a(rct) 

$r1 * status 

0000 - ok to send Icb 

.0001 - user exceeded flow control values 
The routine performs the following' function: 

1. Retrieves the current read or transmit credit count from 
the 1th tt, this Is determined from the iorb function 
code. 

2. If the count Is zero, call the dequeue and post routine 
with an unsuccesful error status, return to the caller. 

3. If the count Is non zero, return to the caller. 

2.5.1 POST ORDER FLOW CONTROL ROUTINE 

The post order flow control routine Is Invoked via a Inj 
from the recleve or transmit data post request processing 
routines. The routine requires the following input parameters: 

$b 1 = a(Icb ) 

$b2 = a(rct) 

$b5 = a(return) 

The routine supplies the following output parameters: 
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$b1 = a(Icb) 

$b2 * a(rct) 

$r1 55 status 

0000 - ok to send Icb 

0001 - user exceeded flow control values 
The routine performs the following function: 

1. Retrieves the current read or transmit credit count from 
the 1th tt, this is determined from the Icb function 
code. 

2. Add to the current count the credit value in the Icb. 

3. Return to the caller. 


4 £DL 
TBD 

5 ISSUES 


I ■ 
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